MMM MMM GGGGGGGGGGGG 
MMM MMM GGGGGGGGG6GGG 
MMM MMM GGGGGGGGG6G6GG 
MMMMMM = MMMMMM =6GGG 

MMMMMM = MMMMMM =6GGG 

MMAMMM =6MMMMMM =6GGG 

MMM 6 MMM = =OMMM «GGG 

MMM = 6MMM =O MMM «GGG 

MAM = 60OMMM = OMMM «GGG 

MMM MMM GGG 

MMM MMM GGG 

MMM MMM GGG 

MMM MMM GGG G6GGGGGGGG 
MMM MMM GGG 666666666 
MMM MMM GGG 6GGGGGG6GG 
MMM MMM GGG GGG 
MMM MMM GGG GGG 
MMM MMM GGG GGG 
MMM MMM GGGGGGGGG 
MMM MMM GGGGGGGGG 
MMM MMM GGGGGGGGG 


C 12 


AAI I tH A tS 
AAA tt tt HH tS tH 
tt tt a St SH Se 


L 

LLELLLELLLLLLLLL 
LLLLLLLLLLLLLLL 
LELLLLLLLLLLLLL 


FE a ee a a el el el el el 


SN 
Ro ono 


**F ILE**1D**SMGDATSTR 
SSSSSSSS MM MM GGGGGGGG DDDDDDDD AAAAAA TTTTTTITIT SSSSSSSS TTTTITTTTT RRRRRRRR 
SSSSSSSS MM MM GGGGGGGG DDDDDDDD AAAAAA TTTTTTTITTT SSSSSSSS_ TTTTTTTTTT RRRRRRAR 
$$ MMMM MMMM «GG DD DD AA aA TT SS TT RR RR 
$$ MMMM MMMM 6GG DD DD AA ‘lal TT SS TT RR RR 
$$ MM 66MM OMM «OGG DD DD AA aA TT SS TT RR RR 
Ss MM 66MM UMM «OGG DD DD AA AB TT SS TT RR RR 
SSSSSS MM MM GG DD DD AA AL TT SSSSSS TT RRRRRRRR 
SSSSSS MM MM GG DD DD AA BB TT SSSSSS TT RRRRRRRR 
SS MM MM GG GGGGGG DD DD AAAAAAAAAA TT SS TT RR RR 
SS MM MM GG GGGGGG DD DD AAAAAAAAAA TT SS TT RR RR 
SS MM MM GG GG DD DD AA AA TT SS TT RR RR cece 
SS MM MM GG GG DD DD AA ak TT SS TT RR RR eeee 
SSSSSSSS MM MM GGGGGG DDDDDDDD AA AA TT SSSSSSSS TT RR RR esse 
SSSSSSSS MM MM GGGGGG DDDDDDDD AL AA TT SSSSSSSS TT RR RR ceee 
RRRRRRRR EEEEEEEEEE 000000 
RRRRRRRR EEEEEEEEEE QQQ000 
RR RR EE QQ QQ 
RR RR EE QQ QQ 
RR RR EE QQ QQ 
RR RR EE QQ QQ 
RRRRRRRR EEEEEEEE QQ QQ 
RRRRRRRR EEEEEEEE QQ 
RR RR EE QQ QQ QQ 
RR RR EE QQ QQ QQ 
RR RR EE QQ Q 
RR RR EE QQ QQ 
RR RR EEEEEEEEEE QaQQg a0 
RR RR EEEEEEEEEE Qa0a aa 
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: Pete Structure Definition eter r ft. pres facility 
File: SMGDATSTR.REQ Edit: STAN 

i 

i eeeeereerereereerereeeereeenereteereeteeneeeeeenteeneteteeeeeeeeeeereeeeeeee 


ie COPYRIGHT (c) 1978, 1980, 1982, 1984 BY 
ie DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASSACHUSETTS. 
ie ALL RIGHTS RESERVED. 


® 
® 
tt 
w 
' & 
is THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY BE USED AND COPIED 
i ONLY IN ACCORDANCE WITH THE TERMS OF SUCH LICENSE AND WITH THE 
it INCLUSION OF THE ABOVE COPYRIGHT NOTICE. THIS SOFTWARE OR ANY OTHER 
if COPIES THEREOF MAY NOT BE PROVIDED OR OTHERWISE MADE AVAILABLE TOANY © 
ie OTHER PERSON. NO TITLE TO AND OWNERSHIP OF THE SOFTWARE IS HEREBY * 
ie TRANSFERRED. * 
® 
jf THE INFORMATION IN THIS SOFTWARE 1S SUBJECT TO CHANGE WITHOUT NOTICE 
is SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL EQUIPMENT ®* 
is CORPORATION. . 
® 
® 
& 
a7 
ce 
® 


't DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF ITS 
!* SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DIGITAL. 


eRe Ree ERE RA AERA RARER AEEAREREAAA RARE AEAAAAEAAAAAAAAAAAAE HARARE eee ee 


1e¢ 

! FACILITY: Screen Management 

i ABSTRACT: 

This file contains data structure definitions for screen management 


routines. Display Control Block, Pasteboard Control Block, Window 
Control Block, and Pasting Packet are defined here. 


i MODIFIED BY: 


' 
' 
' 
' 
' 
' 
' 
' 
‘ 
' 
' 
' 
! 1-001 = Original. AL 15nere 1963 

: 1-002 - Expand PBCB hold PBCB_L_MODE_SETTINGS. RKR 17-Mar-1983. 
' 

' 

' 

' 

' 

‘ 

' 

' 

' 

' 

' 

' 


3 


Add S titeret for initial Setting of PBCB_L_MODE_SETTINGS. 

: -Mar-1 

' 1-004 - had tuff for borders, alternate character sets, etc. 
RKR 24-Mar-1985. 


Corrections to Last edit. RKR 24-Mar-1983. 
Expand WCB and PP structures. RKR gener 1985. 


1 o 
' le - 
: 1-007 - Fix yee 10 n last edit. RKR 38-Mar- 
! 4 - Pull rie COLOR out of PBCB since we don't know what 


o do with it. “Add stuff pertaining to borders. 
! RER gear lid 3. 
4 - More fixes. 7 4-April-1983. 
' 1-010 = Clean up rest of border masks. RKR 5-April-1983 
1-011 = More additions for labeled borders. RKR 7-April-1983. 


aiameenenmmenmenee w 
t< 3S 


nro--Lae ron 


>i 


SMGDATSTP.REQ; 1 16-SEP-1984 16:57:14.48 Page 2 


1-3) = Add more fields to PBCB and PP. RKR 14-APR-1983. 
15 -R fused ‘to the bits for the Line- rawing character Sef is the 


used to eos igre ea borest element. RKR 
1-014 = Defi more bi n the 0 one to mean that all Lines ore 
full (and thus scrolling sh Reale occur thereafter), and one 
mean that column yas written (useful on the next urite 
1-015 = Seting orostt bie tn “the B and CB. PLL 29-Apr-1983 
- Define a n the an “Apr- 
3 5 Ss - w tie n PBCB. AN BcAprs 888" (2 ery). 


Feat PID to PBID - * not to aKa oy @ pasteboard id 
with a process id. 
4 = ogced event 99 numbers to PBCB. STAN 30-Apr-1983 


haged Smee. LONGEST. SEQUENCE. 
Added output er fields to PBCB. 
Added rows on columns to PBCB. 


1-019 - ie 3-Ma 
Allow to, 16 pasteboards. 
nay 1905 AST routine into PBCB. Literally! 


1-021 = Add P x 02 PB_CONTROL. salts ti field in PP. RKR 5S-MAY-1983 

¢ = Add PP-V-CONTI PP_B_CONTROL_BITS. RKR 9-MAY-1983 

- Add t onUtB. PP, and WCB a longword Ehat is the product of 

the mbar of rows * the number of columns. (Not strictly 
true for PP e -- but ignore it. 
RKR 1 Y-1 
Add gr) bebe it to PBCB 
STAN Lag -198 
1-025 = Remove bell bit. PLL ty be 
1-026 = Extend To in B enc icoet on of backup DCB logic. 
poses ye reek MAX_VD == should no longer be needed. 
1-027 - aoe words in one DCB to store the top and bottom of a scrolling 
egion. PLL 25-m ag he 
1-028 - Ad new fields to PP and PBCB. RKR 26-MAY-1983. 
1-029 - New fields to PBCB for nai thoxes et. al. STAN 1-Jun-1983. 


1-030 - nore of same. STAN met 
1 le- e of same. STAN 15-Jun-19 
1 2- haa d DCB LV LAB "CENTER cenavel “bit to DCB_L_CONTROL_BITS. 
1-033 - eke PP_WeR nd PP_W_COL signed fields. 
RER 14-JUR—19 9 


1-038 - Add bit DCB_V af e" parce. RKR 17-JUN-1983. 
5 - Aye for ut sites in PBCB. STAN 18-Jun-1983. 
Made LAS cfitkeut s in PBCB signed. 
Created aicros for r declaring s + ho) ng 
Made CURSOR position in PBC 
1-036 = Add structures to DCB and WCB “dating with Line characteristics 
iike ae tbe Double-High, et 
1-037 - ey bit to DCB to mark as used for autobending. PLL 7-Jul-1983 
1-038 - Add more longwords to DCB for eyggeonetns (used to parse 
escape sequences). PLL 8-Jul-1 
1-039 - Add 2 words to PBCB to record where the physical scrolling 
region is on the terminal. 


=" 
u 
o 
~N 
= 
t 


LIT 


MAC 


1-047 


SMGDATSTR.REQ;1 


16-SEP-1984 16:57:11.48 Page 3 


1 Heat bs 

typo. | RER i1-JuL- 1983 , 

Save r Rice sarajnat width ong h ight. ha 22-Aug-1983 

STAN 9 ine characteris types 

Add a es tion icon attribute b t to e DCB, PLL 1-Sep-1983 

Get rid of 2 unused fields in the DCB by renaming one to 

a simulated. dev ce type and leaving the other one as a placeholder. 


sits tere inal characteristics constants. 
-Sep- 
pee o 70.25 aS 8, 4 LL by turning it into DCB_B_LABEL_REND. 
Add a user Une “drawing bit she rents Ejon attribute. PLL 21-Sep-1983 
Background color byte. eon aT 
STAN 14-Oct-1983. Added w ‘ge. and high bits; AST-reentrancy bits. 
AN - CTRL/O b 
- Add sence) control/O bit. 
STAN 15-Jan-1984. nae TERM 
STAN 21-Feb-19 Add LF and BS optimization bits in PBD. 
STAN 6-Mar-1983. Add woThas Pict 


P 
t 
e 
s 
t 
p 
.*) 
q 
p 
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'¢ 
; Critical sizes and counts for virtual displays and pasteboards 


LITERAL 

PBD_K_MAX_PB = 16, Maximum number of pasteboards we can track. 
it ontrols the range of pasteboard id's we 
will allocate and the size of the pasteboard 
directory (PBD) structure in OWN storage; 
Currently constrained not to exceeed b 
usage of FFC instruction in SGET_NEXT_PID 


SMGSK_LONGEST_SEQUENCE = 255; 


! Longest control or eecane sequence that 

can be returned by TERMTABLE routines. 
This value can be used to preallocate a 
buffer to hold the text or can be used to tell 
if the next sequence desired could overflow 
your buffer. 


y 


ee 


SMC 
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i Contro 


'¢ 
! Virtual Display Control Block (DCB) 


SSS SSSSSSSSSSSSSSSSSSSSSSSSSSSSISSGSS 


Hee data gsrusture defines the layout of a Virtual ya 

2 ot he area is allocated in heap storage. “ 
lock is allo cated, for ee nee, virtual display created x callers. 
t contains dimensions o My Y irtual display and pointers to other 
i buffers associated with th nis d yt? " also contains pointers to 
the pasteboards onto which it is pasted. This area is deallocated 
i when the virtual display is deleted -- > pet when it is unpasted. 


MACRO 


DCB_Q_COORD 0, 09. 0%, ! Really 0, 0 0 

! Quadword stattie Ag next four words fase 4 fields 

i define the coordinate system for this virtual display 

! and their address is transmitted to pass the 4 fields 

! as a single parameter 

pocB -4 ROW START = g. - 16, O02, |! Row number of 1st row. (=1) 
OWS = 2, 0, 16, OX, | Number of rows 

ocB “unc COC_START = 4, 0, i Col number of Ist col (=1) 

o 9. i Number of columns 


Really © 
Dynamic erta yh ee 
for border la el text 


DCB-W-NO_COLS = 
DCB_Q_LABEL_DESC = 8, 0, 00, 0%, 


DCB_A_TEXT_BUF = 16, 0, 32, O02, ! Addr. of buffer containing 
! text for this virtual 
! display. 

DCB_A_ATTR_BUF = 20, 0, 32, 0%, Addr. of buffer containing 


video attributes for each 
sberec ter position in 


DCB_A_CHAR_SET_BUF = 24, 0, 32, "%, Addr. of buffer genta tatag 
Sheorecher set codes 
Sach character in TEXT "BUF. 
s buffer allocated only 


ete needed. 


Number of Levels of 
batching in effect for this 
display. 

Incremented by ce 
SMGSSTART_DISPLAY  OpbaTE 
and Cogresent | toured zero 


DCB_L_BATCH_LEVEL = 28, 0, 32, 0%, 


scr en KE when th 
variable is zero. 
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ill 
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DCB_W_CURSOR_ROW = 40, 0, 
DCB_W_CURSOR_COL = 42, 0, 
DCB_W_LABEL_UNITS = 44, 0, 
DCB_B_DEF _VIDEO_ATTR= 46, 0, 
DCB_V_RENBOL = 46, 0, 
DCB_V_RENREV = 46, 1, 
DCB_V_RENBLK = 46, ¢° 
DCB_V_RENUND = 46, 5, 


DCB_B_DEF _DISPLAY_ATTR=47,0, 
DCB_V_BORDERED = 47, 0, 
DCB_V_TRUNC_ICON = 47,1, 
DCB_V_DISPLAY_CONTROLS. = 


DCB_B_DEF_CHAR_SET = 48, 0, 


DCB_B_LABEL_POS = 49, 0, 


DCB_B_LABEL_CHAR_SET= 50, 0, 


DCB_B8_LABEL_REND = $1, 0, 
DCB_L_CONTROL_BITS = 52, 0, 
DCB_V_FULL = 52, 0, 


DCB_V_COL_80 = 52, 1, 


33; 


0%, 


0%, 


0%, 
0%, 
0%, 


H 
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Above two longwords are the 
queue header for the chain 
of Pasting Packets tied to 
this virtual display. 


Cyreer row position in this 
virtual display 


Cursor col position in this 
virtual display 


Starting position in the 
Line or column indicated by 
DCB_B_LABEL_POS 


Botauts video attributes of 
this virtual display 

Bold 

peyerse video 

Blink 


Underline 


Default display attributes 
of this virtual display 
Bordered 


Flag to use truncation icon 


Flag to Gispley carriage control 
characters such a <CR> instead 
of execute them 


Default character set for 
all text in this virtual 
display. 


Code for positioning of 
d Label: " 


rder 
8 = Tep border Line 

= Bottom border Line 
§ = Left border Line 

= Right border Line 


Code for character set of 
border label. 


Rendition for border label 
Control bits 


ALL display Lines used 
(next op may scroll) 


Column 80 just written 


MAC 


hn IRIE . 
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DCB_V_LABEL_CENTER=52,2, 1, O02, ! If set indicates that 
! border Label shou 
centered -- even virt. 


! display is redimensioned. 


' if this bit is set it 
: indicates that this virtual 
! display & eres block 
'¢ such a way that 
' all ten beet _ 

packets need te aeve 5 heir 
' constants f oe cule 
! However, th ; ohenee eal 

ef display was 

“= —. SAS a8 t be 


! SMG END Hi SPLAY UPDATE 

' senses This bit whenever it 
! makes the tr sition to 

' batch_ sqvets and performs 
! the pSting packet recalc. 

: a t yo time, then resets 


DCB_V_PP_MISMATCH=52, 3, 1, OX, 


DCB_V_AUTOBENDED =52, 4, 1, O2, ! This DC crested by 
! autobenced routin 


| 
| 
DCB_V_ALLOW_ESC = 52, 5, 1, O%, ! Parse escape sequences when set 
DCB_V_LOCKED = 52,6, 1, 0%, ! OCB is locked for our use 


DCB_L_DID = 56, 0, 32, 0%, ! Virtual display id 
: ‘Curren ly os gipereee of 
! the OCB itse 

DCB_L_BUF SIZE = 60, 0, 32, 0%, ! = .DCB CDCB_W_NO_ROWS 


! DCB COCB"W=NO-COLS 


DCB_A_BACKUP_DCB = 64, 0, 32, 02, ! If non-zero, address of the 


i the state of the DCB at the 
! time batching started. 


8, Of, |! Code to mark this structure 
! as being a OCB 


DCB_W_DCB_LENGTH = 69, 0, 16, 0%, ! Stored length of a DCB 
DCB_B_FILL_2 = 71, 0, 8, O%, : 

DCB_W_TOP_OF_SCRREG = 72, 0, 16, OX, 
DCB_W_BOTTOM_OF _SCRREG 


= 


DCB_B_STRUCT_TYPE 


Top Line in scrolling region 
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! Bottom Line in scrolling region 
: Adress of the | 
! characteristics Ae 


= 74, 0, 16, 0%, 


DCB_A_LINE_CHAR = 76, 0, 32, 0%, 


i This vector, one byte for 
each Line, ne a. Single s whether 
; She. t e, Double- 


: High. ne fe Sing etc. 
Th 


! 

' 

! 

' 

! 

' 

! 

i be DCB_W_NO_ROWS ¢ 1 bytes 

' Long 6 Tt sen | be indexed 

' directly Bye . 

! (1 thro h DCB 
DCB_SIM_CONTROL = 80, 0, 32. OX. ! Control bits for ~SRCSSSIM. TERM 
DCB_ARG_1 = 84, 0, 32, 0%, |! Control sec arg 
DCB_ARG_2 = S - 32, O%, ! Control seq arg 
DCB_SIM_DEV_TYPE = 92, 0, 32. 02. ! Device type to simulate 
DCB_UNUSED = 96 z ! Unused 
DCB-SAVED_HPOS = 106, . Ob. | Seved cursor coluan 
DCB_SAVED_VERT = 1958 %, ! Saved cursor row 
DCB-SAVED_VIDEO_ATTR = 108 ° 6, 5, Of; ! Saved video attributes 


LITERAL 


DCB_K_STRUCT_TYPE = 2x°11", ! Code stored in DCB CDOCB_B_STRUCT_TYPE) 
i to mark is as being a DCB. 


DCB_K_SIZE = 112; ! Total number of bytes in a DCB 
MACRO 
SDCB_DECL = BLOCKCDCB_K_SIZE.BYTE) 2; 


© 
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! 
; Pasteboard Control Block (PBCB) 

‘ This data structure resides in HEAP prerege. One of these areas 
' is allocated whenever a new stream is qstes; shed for the first time. 
' It is deallocated when the pas sbeery s deleted. 

' It contains the pirgenentet information associated with a pasteboard 

: and pointers to PoCB-related structures like the WCB. 


MACRO 
CB_A_PP_NEXT s- 4, g. 3: oR. 

PBCB_A_PP_PREV = 46, 0, 32, 0%, 

! Previous two longwords serve 

! as a queve header for the 

! chain of gesting ackets of 

! all the virtual yon that 
! are pasted to this pasteboard. 

PBCB_A_WCB = 8, 0, 32, 0%, 

! Addr. of window control block 
! (WCB) 

PBCB_L_MODE SETTINGS = 12, 0, 32, O%, ! Mode setting for this PBCB 
Pete_v_BuF ENABLED = 12, 0, 1, O%, ! =1 if buffering enabled 
PBCB_V_MINOPD ©. 32, ts Ba Ge ! =1 if minimal update enabled 
PBCB_V_CLEAR_SCREEN= 12, ¢° 1, O2, ! =1 if should clear screen on exit 
PBCB_V_NOTABS = 12, 3, 1, O%, : #1 Av one should not use physical 

: abs. 

PBCB_B_DEVTYPE = 16, 0, 8, Of, ! Logical device type 

' Status are defined in 

! SMGTERM.REQ and 

; earens’y are: 

! — UNKNOW = 0 

: vi? = 1 

gab: = ¢ 

, ti = 

! VTFOREIGN = 4 

! HARDCOPY = 5 
PBCB_B_PARITY = 17, 0, 8, O%, ! parity flags 
PBCB_W_DEVNAM_LEN = 18, 0, 16, 0%, ! Length of the 

' resultant device name 

} string contained in 

! PBCB_T_DEVNAM. 
PBCB_L_PBID = 20, 0, 32, 0%, ! Pasteboard id 
PBCB_T_DEVNAM = 24,0, 0, 0%, A 64-byte area. This 


buffer contains the 
resultant device name 
ate ng. Its genet 

s contained in 
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PBCB_R_CHARBUF 


PBCB_L_DEVCHAR 
PBCB_B_CLASS 


PBCB_W_WIDTH 
PBCB_L_DEVDEPEND 


PBCB_B_ROWS 


PBCB_L_DEVDEPEND2 


PBCB_W_CHAN 


PBCB_B_EFN 
PBCB_B_ASYNC_EFN 


PBCB_A_MBX_MSG_LIST 
PBCB_A_OUTPUT_BUFFER 


PBCB_W_OUTPUT_BUF SIZ 
PBCB_W_OUTPUT_BUFLEN 


PBCB_R_EXIT_BLOCK 


11 LINK 
ITZADDR 
TZARGCNT 


~PBCB 


LEX 
EX 
EX 
m2, 
EX 


PBCB_B_PHY_DEV_TYPE= 


92, 


0%, 


0%, 
0%, 
0%, 


0%, 
0%, 


0%, 


0%, 


0%, 
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PBCO_W_DEVNAM_LEN. 


Start of 12-byte 
characteristics buffer 


Device characteristics 
Device class, e.g. DCS_TERM 


Physi ° 
ene sth onder 


Device width 


Primary device dependent 
bits. These are the bits 
of the TI$V_xyz flavor. 


Number of rows on terminal 
(overlaps previous field) 


a device 
Sopengen bits. fhese 
org the bits of the 

T2$V_xyz flavor. 


Channel number. 0 me 
Naeem as been wees 1ened 
yet. 


Primary output event flag 


Secondary output event flag 
used for asynchronous operations 


List of messages that c 
from our associated nel lben 


Address of buffer used to 
buffer up output sequences. 


(Maximum) size of output buffer 


furrent length of racters 4 buffer 
-@. number of characters in 
the buffer. 0 means the 

buffer is empty. 


Exit block (5 longwords) 


system forward Link to next block 
address of our exit handler 
argument count (=2) 

arg 1: address to store exit reason 
arg 2: our PBCB address 


(pc SSS es 
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PBCB_L_EXIT_REASON : 


F BAND _RTN 
TRY MASK 


PBCB_A_BAND ROUTINE = 


PBCB_L_BAND_AST_ARG = 
PBCB_M_BAND_MASK . 
PBCB_L_BATCH_LEVEL : 


PBCB_W_FIRST_CHANGED_ROW 
PBCB_W_LAST_CHANGED 
PBCB_W_FIRST CHANGED COL 
PBCB_W “LAST _CHANGED_COL 


PBCB_A_OUTNAM = 


PBCB_W_SPEED = 
PatB~B_TSPEED = 
PBCB~B-RSPEED = 

PBCB_W_FILL : 
PBCB~B_CRFILL = 
PBCB-B-LFFILL s 

PBCB_A_BROADCAST_R > 

PBCB”L BROADCAST “ARG = 

PBCB-A-UN UNSOLICIT“RIN = 

PBCB-L-UNSOLICIT“ARG = 


136, 0, 


176, 0, 32, 0%, 


a a as 


PBCB_Q_BROADCAST_MSG_QUEUE = 200,0, 


eee 
esse 
ne 
ee oe oe oad 
see 8 


a oe 


se. 6 


o oooco ooo oOo 


® 
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exit reason (address stored 
raget argument in exit 


8800" tou routine resides here. 
ou a By net believe it, 
Bh o. The first 

‘ ~. the entry mask. 


Address of generic 
04 out-of-band AST handler 


Address of user's AST routine 
or out-of-band characters. 
means out-of-band ASTs 

are not ena 


User's arg to his AST routine 


Character mask for out-of- 
band ASTs currently in aj vees 
sete ing level i non-0 

then bat ching is in effect. 


Next 4 fields are set 
during rh from 
virtual d 


have changed since 
last call to outpu*. 


! Address of buffer containing 

! the guteut ny oe 

: specified oy te e 

! (or “*SYSSOUTPUT' 7° net specified). 


' Terminal speed 
' srangats speed 
' rece 

' Terminal fill 
' cR fill 

' Le fill 


! Broadcast mailbox AST routine 
; eerste mailbox and | argument 


ve speed 


ted input mailbox AST routine 


i Unsolicited input mailbox AST argument 
! Queue for holding broadcast messages 


oe ee ee ee ee ee Te Te De De . . * . . * . * . . . . * * * . . . * . . . . . . 
£ 
iw ~~ ot! 


- 
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PBCB_L_SMGMBX_FLINK = 
PBCB"L-SMGMBX"BLINK = 


PBCB_W_FLAGS = 
PBCB_V_BROADCAST = 
CB_V_UNSOLIC = 
PBCB_V_SMGMBX_INIT = 
PBCB_V_RMS = 
PBCB_V_LOCKED = 
PBCB_V_REBUILD = 
PBCB_V_CONTROLO = 
PBCB_V_CANCEL_CONTROLO= 
PBCB_V_BS = 
PBCB_V_COMPLEX_BORDER= 
PBCB_W_ASYNC_CHAN z 
PBCB_W_MBX_CRAN = 
PBCB_W_SMGMBX_BUFSIZ = 
PBCB_A_SMGMBX_BUFFER = 
PBCB_Q_SMGMBX~10SB = 
PBCB_W_OUTNAM_LEN = 
PBCB_W_ORIG_WT = 
PBCB_A_FAB = 
PBCB_A_RAB = 
PBCB_A_RBF = 


PBCB_W_TOP_SCROLL_LINE 
PBCB-W~BOT SCROLL ~LINE 


PBCB_B_ORIG_HEIGHT 2 


PBCB_B_BACKGROUND_COLOR= 
PBCB-W~INTERNAL_ATTR 
Pets IDE 


PBC 
PBCB_L_TERMTABLE 
PBCB-L LONGEST SEQUENCE 
PBCB-A~CAP_BUFFER > 
PBCB-L~CAP~LENGTH = 
PBCB-R-BORDER_VECTOR = 


LITERAL 
PBCB_K_SIZE = 332; 
MACRO 


N 
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es 
kad nd 
ror 
e. 
oo 

VPRPL HLTA SL SLTE Tevtaetve veve 
es. 


et tt ee > 3 Op 


se © te &e &e & & S&S 
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eee eee eee 
eee seen es 
eee eee sees 
Ooooooooooo 
Pe TS TL VL TK HL TL HL ELL 
eee sees eeees 
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Forward Link 
Backward Link 


Flags 

Broadcast msg trapping enabled 
solicited Input not’ fication enabled 
tet s AST routine this is 

en nitialization call 
means using RMS for output 

PBCB ‘s sogaee 

A rebuild is needed 

Previous output aborted by CTRL/O 
ancel CTRL/O on next Q10 
means terminal can do backspace 


1 means some border capability 
is longer than a byte 


Asynchronous channel to terminnal 
Mailbox channel 

Max message size for mailbox 
Address of mailbox buffer 

1/0 status block for mbx read 
Length of output name string 
Original width of terminal 
Address of FAB (if file) 

Address of RAB (if file) 

Address of record buffer 


Top scroll Line 
Bottom scroll Line 
Above 2 words record 
where the physical 
scrolling region is 
currently set on the 

terminal. 
Original number of rows on 
terminal (reserved for 

future use). 
Background color 

Internal attributes 
Pasteboard allows wide lines 
Pasteboard allows high wide Lines 
Pod allows physical tabs 
porvospendtng TERMTABLE. 
Longest capabil fy sequence 
Address of capabi ity uffer 

am of last capability gotten 
6-longword border vector 


' Total size of PBCB in bytes. 
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SPBCB_DECL = BLOCKCPBCB_K_SIZE,BYTEJ 2%; 
LITERAL ! masks for bits in field PBCB_L_MODE_SETTINGS 


PBCB_M_BUF ENABLED = 1, ! =1 if buffering enabled 

PBCB_M_MINOPD = 2, ! =1 if minimal update enabled 

PBCB_M_CLEAR SCREEN = 4, ! =1 if should clear screen on image exit 

PBCB_M_NOTABS = 8; ! =1 if SMG should not use physical tabs 
LITERAL 


PBCB_K_DEF _MODE_SETTINGS = 


PBCB_M_MINUPD ; ! Minimum update enabled 


ee 


eef 
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a 


Window Control Block (WCB) 


pourrentsy? one WCB associated w 


Mest” an output coke Vee we ALTEXT 
their contents swap At the Same 


in time ote _A_SCR_TEXT_BUF one ¥ 
currently onthe screen. wWCB_A 
to construct the next screen fu te 


MACRO 
WCB_Q_COORD 0, 0, 00, 02, 


transmit these 4 fields 


WCB_W_ROW START = 9 
WCB-W_NO RowS = 
w(B -¥- ~{ot START 

WCB-W_NO_COLS 


nu 
oe 
esse 8 


WCB_A_TEXT_BUF = 8, 0, 32, 0%, 
WCB_A_ATTR_BUF = 12, 0, 32, 0%, 


WCB_A_CHAR_SET_BUF 


16, 0, 32, O%, 


WCB_A_SCR_TEXT_BUF 


20, 0, 32, O%, 


WCB_A_SCR_ATTR_BUF 


24, 0, 32, 0%, 


WCB_A_SCR_CHAR_SET_BUF=28, 0, 32, O%, 


WCB_W_CURR_CUR_ROW = 8. 16 -, # 
WCB_W_CURR—CURCOL ; 16, 1%, 


WCB_W_OLD_CUR_ROW = 36, 0, 16, 1%, 
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This data structure resiees in heap storage. There is 
th each pasteboard and ‘s pointed to 


UF ~~. WCB_A_SCR_TEXT_BUF have 
time, WCB_A_ATTR_BOF and 
— A_SCR_ATTR_BUF a chett contents snipped: “Hence, “ any gots 


TR_BUF record wha 


rear ABE and WCB_A_ATTR_BUF are used 


! Really 0, 0, 


64, 0 
Quadword containing next four words. The four fields 
define the coordinate system for the pasteboard and 
hence the windoy buffer. 


Their address is passed to 
as a single parameter. 


' Row number a Ist row (=1) 
' Number of ro 

Col number ri Ist col (=1) 
! Number of cols 


Address of a text buffer 
for this window. 


Address of attribute buffer 
for this window. 


Address of character set 
buffer for this window. 
This buffer is allocated 
only if needed. 


Address of text buffer 
representing what is 
currently on the screen. 


Address of attribute buffer 
associated wit 
WCB_A_SCR_TEXT_BUF 


Address of character set 
Bea A. associated with 


UF. 
Allocated only if needed. 


Cursor position in 
WCB_A_TEXT_BUF. 
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WCB_W_OLD_CUR_COL = 38, 0, 16, 1%, 


WCB_L_BUFSIZE = 40, 0, 32, 0%, 


WCB_A_LINE_CHAR = 44, 0, 32, 0%, 


WCB_A_SCR_LINE_CHAR = 48, 0, 32, 0%; 
LITERAL 

WCB_K_SIZE = 52; ! No. of bytes in 
MACRO 


SWCB_DECL = BLOCKCWCB_K_SIZE,BYTE) %; 
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on in 
T_BUF. 
NO_ROWS) * 
NO_COLS 


t 
WCB_A_S E 
= .WCB 

WCB LW 


Address of Line 
characteristics vector for 
text buffer. 

This vector, one byte for 
each Line, records whether 
the Line is Single, Double- 
High, Double-Wide, etc. 
This vector is allocated to 
be WCB_W_NO_ROW ytes 
Long sO Tt Can be indexed 
directly by row number 

(1 through WCB_W_NO_ROWS). 


Address of Line 
characteristics vector for 
screen text buffer. 

This vector, one byte for 
each Line, records whether 
the Line is Single, Double- 
A ae Double-Wide, etc. 
This vector is allocated to 
be WCB_W_NO_ROWS + 1 bytes 
Long so Tt Can be indexed 
directly by row number 

(1 through WCB_W_NO_ROWS). 


Cursor pes 
te 


i 
| 
CBW. 
CBW 


i 
¥ 
w 
w 
j 


wCB 


15 
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Pasting Packet (PP) 
his data structure defines the layout of a Pasting Packet. 


! this area is allocated in heap storage. One such structure exists for 
: eyer ered Ey a virtual d ee @ pasteboard. 


It_exists 
simultaneously on two queues -- t ueue (DCB_A_PP_NEXT) pooped in 
C 


! the OCB which gontalne the queue of PP's representing to whi 
! pasteboards this 8 

i of the queue (PBCB_A_PP_NEXT) headed 
! queue of PP's représénting all virtual displays pasted to this 


ocB asted, and ef the same time, it is a member 
n 


the PBCB which contains the 


pasteboard. 
CRO 
PP_A_NEXT_DCB = 0, 0. 32, O2. 
PP_A_PREV_DCB = 4, 0, 32, 0%, 
| fhe previous 2 longwords serve as 
! a@ queue entry for wre of enqueing 
! onto queue DCB_A_PP_NEXT == the queue 
' of all pasteboards fo which this 
! virtual display is pasted. 
PP_A_NEXT_PBCB = - O. 32. O82. 
PP—~A_PREV_PBCB = 3 8: 3: ts 


' fhe previous 2 longwords serve as 

' @ queue entry for purposes of enqueing 
' onto queue PBCB_A_PP_NEXT == the queue 
' of all virtual displays which are 

! pasted to this pasteboard. 


PP_A_DCB_ADDR = 16, 0, 32, 0%, 
| Address of the DCB involved in this 
! pasting. 

PP_A_PBCB_ADDR = 20, 0, 32, O%, 
! Address of the PBCB involved in this 
! pasting. 

PP_W_ROW = 24, 0, 16, 1%, 
' The row number of the pasteboard onto 
' which row 1 of the virtual display 
! maps. 

PP_wW_COL = 26, 0, 16, 1%, 
' fhe column number of the pasteboard 
! onto which column 1 of the virtual 
! display maps. 

PP_W_ROWS_TO_MOVE = 28, 0, 16, 0%, 
' fhe number of rows which have to be 
' moved from the display buffer to the 
! window buffer. If zero, the next 3 
! fields are meaningless. 

PP_W_FROM_ INDEX = 


30, 0, 16, 0. 
' fhe byte index beyond the begining of 
' a source buffer which represents the 
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PP_w_TO_INDEX : 


PP_W_MOVE_LENGTH = 


PP_W_LABEL_BYTES_TO_MOVE = 


PP_W_SRC_LABEL_OFF - 


PP_W_DST_LABEL_OFF : 


i Hav ng these 
i output opera 


eres aces ererececese 
° 
> 
a 
w 
a 
a> 
en 
-_ 
a~ 


PP_B_CONTROL_BITS = 


! to window buffer run faster s 
! have to b> continually recomputed on the fly. 


' Ist byte postion to be moved when 
i copy ng from display buffers to 
! window buffers. 


725, 

; ne'byté. in ies beyond the begining of 
'~@ nation buffer bs represents 
: 2s jst gyte to be deposited when 

' copy ng from a display buffers to 

! ndow buffers. 

34 
1 tne’ a By of columns to be moved from 
splay ers to window buffers. 

i display buff indow buff 


36, 0, 16 

1 the’ paar of bytes of the border 

i Label which need to be moved to the 

i WCB text buffer when the virtual 

i a is mapped to the WCB text 

i buffer. This field may be zero if no 
i characters fit the way the display is 
i pasted. 


38 16, 
! tne’ otttet * o-based? peyond the 
! bog inning of the the label string 
i which represents the Ist byte of the 
ieee AF ater 
= Len of_labe 
i CBP .O LABEL BYTES. "8 i MOVE]). 
i this rete ma ‘st be valid i 
i PP CPP_W_LABEL_BYTES_ 10 MOVE) is 0. 


40 16, 

' tne ot fdet “to-base ) beyond the 

i be ginning of .WCB (WCB Penn BYF 

i yhere fhe first t byte of the visible 

i Label Lands. s same offset is used 
i to oh the Rate attribute 
fret in we f » vats 

i 


By a valid rh 
PP Tabet *aYTES. TO_MOVE) is 0. 


! NOTE: The 7 fields above are computed Tet a function 
' of both the dimensions of the virtua 4 

' the qepttton - the pasteboard on wh 
: e ( dimen 


lay and 
ns is pasted. 
sions or pasting position) changes, 


must be recomputed. 
ritet set up as a result of pasting. 


elds § procenputes n the PP makes the 
ng eae from display buffer 
nce these values do not 


ion of mov 


42, 0, 8, 0%, 


F 
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PP_v_OCCLUDED 


PP_V_CONTIG 


PP_L_MOVE SIZE 


PP_PBCB_QUEVE _OFFSET = 8, 
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Home for yarious PP-wide status bits. 


' iat whether the sting of this 

; gorsetey ; pasteboard -- 
7 8 ares into at derat on all snee 
; pasting ro 1 pasteboard -- 
' 


ect 
oded. b= Not occluded 


eres set - bit means thet a és 
i virtual “ies wind (as pas ed) 


— te erv 
single VE-- i.e. the source 
[=p fields are contiguous 


not set, text st be moved on 
bi by row "basis since only the “bytes 
within @ row are contiguous. 


aan ecm —_— 


43, bp? 
$ > “be teu x W_ROWS S$_TO_ MOVE) * 
' PP~W_MOVE_LERGTH 


' Next 4 fields tell where on the WCB 

i buffer the part of the virtual display 
i tha seco “i thin the pasteboard 

' projects. l.e., wet area of th 

' WCB buffers pet § 4 -y ied when this 

i virtual disp oy 38 to the 

i pasteboard. ese fields are not 

i meaningful if PP ROWS _ TO MOVE is 

' zero since it thén doesn't even hit 

! the pasteboard. 

i Note: these fields do not take into 

i yo * a tage the virtual display 

' is bordered a most instances this 
i is the right * to do. There 

i one known quir ae nreee to be fixed 
i later-- If av Setunt ‘splay is parted 
i to a row or column which is one uni 

i outsi 2 @ Jane, postepeere aries. 


i then its VE ut 
i since the nt Bus Too will soe 


: re gees to the pasteboard -- but its 
i it h board but i 
: rw 

2 47, * ie. 

= $3. ¢ : : OF: 

= o a oe eB 

s ny - 16, O08; 


: Offset of the queve header for 5 

' pasteboard side of the chain. This is 
foe fak's offset of th 
PBC 


e 
e 
e 
NEXT B field. 


a 
Sd 


- -——- -~-—-———— | 


i~-—— 


4 
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* 


PP_K_SIZE = 55; ! Size in bytes of a PP 
MACRO 
SPP_DECL = BLOCKCPP_K_SIZE,BYTE) 2%; 


MAC 
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te 
i The ipttewtng ore masks of it positions i 
y 


the bytes of the 
! attribute array pointed to ‘ 


n 
A_ATTR_BUF 
LITER 
! Bold rendition 
' Re ryeree wigee © rendition 
' Blink rend 
! Underline rendition 


Line-drawing character set 


este | a.) REM “Grapnit = Zx‘10° : 
if set. this bit indicates that this character must 


oe rende red using the devi ce's ulne=dravioe character 
set. 


| 
ATTR_M_USER_GRAPHIC = £x°40', +H Line-drawing char set 
' This indicates @ amarie. tf -drawin ng Goer scter which 
! must be converted to the device-specif 

! before being output to the screen. 


ATTR_M BORD _FLEn = £x'80'; ! Border control bi 
This bit is used to record that the assoc ated text 
: + hed s (was) not a printable tous his’ Bit a 

t of a border element. bit : 


c character 


“ons 
supp lied by the caller to SMG 8 perest Tehed 
nternally while virtual displa a are being mapped to 
the pasteboard buffer. It is not of interest to the 
output routines 
During the mapping phase, while the various virtual 
ents oe re mapped onto the output window buffer, 


owe fl ereckes™ — an encoding of what pieces of a 
der epengnt must occupy this text slot. 
re ai rtual f tap rays have been mapped to the 
WCB buffers and all intersections of border characters 
ha ave been aE, 7°h byte in the attribute array 
is inspected to see e is set. t th 3° bi f the 
4 t in the attribute byte is eet. the b ss n the text 
2,2 are inspected to see how they should be vey 
device associated with the pestepoare eoge os 
ARF @ Line-drawing character set, the bits in the 
coas Gees ore chenged fo,, he pfngnest ASCII character 
x 
This colluler ar position can lh be’ treated Like any 
other tent po 
ever. f the esses feted o Soetee does support a Line- 
character set, t n the text cell are 
chen to the appr opr ite are aphic ¢c for that line- 
draw pe set and the IC bit in the 
attribe te arr ay byte is cened on 
The bit n f e ext buffer) that encode the desired 
areghie are given below. | 
| 
| 


! These masks are used to set and reset these bits, e.g. 
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| 
———————————————E——— 


: byte_in_attr_array = .byte attr_arry OR ATTR_M_777? 
: byte- in_attr “errey = “byte” -{n- wattr “erry XO KOR ATTR_A_277? a 
‘ se Nag Llowing are the corresponding constants for accessing the 
(Penk apse purposes. 
ATTR.v REND BOLD = x . ! Bold 
vin von ND ARE = Zx'Oi', ; Reverse video 
ATTRAV REND BL = 2x'02', ! Blink 
TTR_V_REND_UND eR = 2x'05", ! Underline 
At 9 seo ret b: = 2x'04', ! Graphic character 
TTR_V_USER_GRAPHIC = 2x'06', ! User graphic character '¢ 
ATIR-V-BORD- ELEM = =_-«EX'07"; ! Border element control bit ; § 
' These bits are used in BLISS constructs Like im 
: IF .(some_place_in_the_attribute spot fer <atiR. V_777,1> ! If set : : 
! These constants are used to check the Line chorestertesics vector. ij 
! The pine characteristics vector is used to specify double wide and : c 
! double high/double wide. 't 
LITERAL 
LINE _K_NORMAL = 9. ! single width and height (must be 0) 
LINE_K_WIDE = 1, ' double wide 
LINE_K_UPPER_HIGH = ¢: ! upper half of double high 
LINE_K_LOWER_HIGH = 3; ! Lower half of double high 
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'¢ 
i The following are bit defini yt j " bits f in the text buffe 
pointed ye be uce Puts A_TEX nF a pa ect cular cell onisiee 
' not @ printable chareck ter, byt an odjng of of what parts of a border 
j_ charac er need t be placed n this posit 
LITERAL 
BORD_M_RIGHT = Zx'O1', 
D-A_ = %x'02', 
BORD _M_LEFT = 2x'04', 
BORD-M_DOWN = 2x‘08', 
BORD_M_HORIZ = BORD_M_RIGHT + BORD_M_LEFT, 
BORD_M_VERT = BORD_M_uP + BORD_M_DOWN, 
BORD_M_ULCORN = BORD_M_DOWN + BORD A ARIGHT. 
BORD _M_URCORN = BORD_M_DOWN + BORD_M_LEFT 
BORD-M"~LLCORN = BORD-M-UP + BORD-M-RIGHT, 
BORD _M_LRCORN = BORD_M_uP + BORD_M_LEFT; 
Certain combinations of the above bit pat erns are meaningful, e.g. 
D_M_VERT + BORD_M_RIGHT represent a ‘'right-T"' graphic 


These bits are us ed to ‘‘OR"’ fogether the right total graphic that is 
me poe FM ot pertic icular position on the screen to represent some 
element of a bo 


! The corresponding bit positions: 


wy 
=< << 
rT 
~s 
7" 
~ 
hunn 
ve 
poset: 
rr = 
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